home *** CD-ROM | disk | FTP | other *** search
/ Amiga Games 1996 July / Amiga Games 1996 #7.iso / userbox / publicdomain / onehand / onehand.doc < prev    next >
Text File  |  1995-11-20  |  3KB  |  79 lines
  1.  
  2.                                   OneHand!
  3.  
  4.  
  5. What Is OneHand?
  6.   OneHand causes user key presses and mouse actions to be qualified with
  7.  the so called qualifier keys. They are the control, the two shift keys,
  8.  the two alt keys, the two Amiga keys and the Caps Lock key. In simple
  9.  English this means that your mouse or keyboard actions are interpreted
  10.  as if you had pressed the any of the above mentioned keys at the same time.
  11. --------------------------------------------------------------------------
  12.  
  13. How OneHand Works?
  14.   It installs an input event handler and by user's request, via
  15.  clicking the corresponding gadgets, adds the qualifier codes to the 
  16.  input event structure. Note that this is NOT equal to physically 
  17.  pressing the qualifier keys. For example you can't reset the computer
  18.  by clicking on the two Amiga and control gadgets.   
  19. --------------------------------------------------------------------------
  20.  
  21. What Is It Used For?
  22.   The real motivation for this program was that a friend had created 
  23.  a Persian font to change the Amiga's working language. The font
  24.  substituted some characters above ASCII 127 with Persian symbols
  25.  (Persian is an Indo-European language but written with Arabic alphabet, 
  26.  with some extensions). To type Persian you have to press some qualifier
  27.  keys. This program can be used to ease this process.
  28.  
  29.   Also, when selecting menu items repeatedly, for example when single
  30.  stepping a program in a debugger, OneHand can be of some use.
  31.  
  32.   People who for any reason can not use both their hands will also
  33.  benefit from it.
  34. --------------------------------------------------------------------------
  35.  
  36. Description of Gadgets:
  37.   CONTROL is represented by the 'Ctrl' gadget. Left and right ALT keys
  38.  with left and right 'Alt' gadgets. Left and right AMIGA keys with
  39.  left and right 'A' gadgets. Left and right SHIFT keys with left and
  40.  right '^' gadgets. And CAPS LOCK is represented by the 'Caps' gadget.
  41.  
  42.   The last remaining gadget, named 'X', is used to move the OneHand
  43.  window across different screens. When the user presses this gadget,
  44.  OneHand's window will close. After 4 seconds, it will reopen its
  45.  window on the screen that is at the front at this time. Note that
  46.  some programs may not tolerate another program opening a window on
  47.  their screens.
  48. --------------------------------------------------------------------------
  49.  
  50. Program Description:
  51.   The program supports both 1.3 and newer OS versions. So theoretically 
  52.  it will be able to run on all Amigas.
  53.  
  54.   The qualifier codes are added to input events as long as the 
  55.  corresponding gadgets are 'pressed'. Caps Lock is active when the 
  56.  'lamp' in the gadget is 'on' (white in default 1.3 and 2.0/3.0 colors).
  57.  This has nothing to do whith the physical situation of the qualifier 
  58.  keys. One can say that the on screen 'keys' have precedence over 
  59.  physical keys.
  60.  
  61.   Under OS 3.0, by clicking the left Amiga key, the left mouse button
  62.  does not act as expected. To overcome this, take the pointer over the
  63.  left 'A' gadget and press left Amiga and Alt keys together (on the real
  64.  keyboard ofcourse!).
  65. --------------------------------------------------------------------------
  66.  
  67.   OneHand is copyrighted, but you can use it freely.
  68.  
  69. Mail (More Reliable):
  70.  
  71.    Kamran Karimi
  72.    89-Nastaran/Ghandehari
  73.    Khosh Shomali str.
  74.    14578 - Tehran
  75.    IRAN
  76.  
  77.  
  78. Internet: karimik@sun.iust.ac.ir
  79.